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1 Introduction 


The purpose ofthis document isto help you get started cresting objects in The Sims. It 
consists of thre parts 


1. Am under-the-hood look at The Sims. Understanding the basics of how this 
‘simulated environment is structured is essential for understanding how to reate 
the routines and marshal the resources necessary to create new objects 

2. A guide to the Edith object editor and debugger. The interpreted nature ofthe 
simulation environment greatly simplifies the debugging process, and is what 
‘makes it posible to drastically extend the simulation by adding new objects, 
Edith lets you watch what is going on inside objects and people while the 
simulation i running, a well as providing facilities for ereating and editing 
Toutines using the visual programming language of the underlying virtual 
‘machine 

43. Some examples of object creation. We start with creating a Joy Booth. A more 
complex exercise, a Mood Adjuster is described. Some yet more complex 
exercises are suggested, 


2 The Sims: A look under the hood 


The Sims’ world is created on top of Eth, which provides a virtual machine pls an 
development environment for that virtual machine. Shipping versions of The Sims have 
the virtual machine but not the development environment. 


A simulation in Edith consists ofa set of objects. The simulation is evolved by running 
cach ofthese objects in turn. Each object has its own (Edith-level) thread and local 
variables. The Edith VM uses cooperative (ve. nom-preemptive) multitasking, soit is 
{important o include explicit global checks in your code to avoid blocking. 


Every object has a set of local data and ase of behaviors, The lcal data provides the 
parameters ofan object, including pointers (indexes really to other objects i is related to 
The st of behaviors consist ofa procedure that implements it (more on this below), a 
procedure that checks to sce whether or not itis possible, and ase of advertisements that 
‘describe its properties in terms of what needs) ofa Sim it wil satisly. Sims (not under 
direct player control) choose what to do by selecting, from all ofthe possible behaviors in 
all ofthe objects, the behavior that maximizes their current happiness. Once they choose 
behavior, the procedure for that behavior (which is part ofthe object) is then run inthe 
thread ofthe Sim itself, so that it hs acces to that Sim's parameters in addition to those 
of its defining environment (the object the behavior is from). All interactions between 
‘objects occur inthis way. Sims themselves are just a somewhat more elaborate object. 


Sometimes there area numberof intermediate objects to implement behaviors. For 
instance, Social Interaction isan object that is created and used when two Sim interact. 
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Each Sim contains behavior calls for each ofthe possible socal interactions (lit, kiss, 
‘). When SimSam decides to run the kiss behavior (which i in SimMary) an invisible 
‘oc intracion object is eeated, The execution of SimSam's thread i then pasted into 
this object (as is SimMary's if she's nt busy) (Access to the parameters af the chosen 
‘Sim is provided through a pointer in the Social Interaction object.) Eating is another 
example of a behavior that involves a large numberof intermediate objects, basically one 
perstep. Notice that this means objects can be dymamically created and destroyed during 
the execution ofa behavior 


Although the objet updates happenin single (underying processor) hea, animations 
and sounds ae exccuted in aneter thea, syachronously with Edilevel operations. 
That is what provides the illusion ofsmulancous activity inthe simulated world, This 
also why there es faieamount of setup that mast he done when otering a rutin th 
tes snimation, and careful checking on exit ‘There aa numer of sublets wih 
animations. For instance, when a Sims aking a shower doesn't actually enter the 
Shower. Instca, ti aldo to routing slo” ofthe shower, which offsets the location 
ff the animation so that coms that the Sim iin the shower. (Try executing aothce 
behavior when the Sim is inthe shower, by elting the Shower Core procedure and 
‘ou'l se teleportation inaction. Implessenting realise simulated ord ef oa 
say!) 


Behavior are implemented in tems of procedures, called tees because ofthe visual 
programming language that Eth ses, The ite ofthe visual programming langage i 
{ormake it esir for content developers to create abjects, nd pethaps someday suppor 
en-us programming 


‘Statements in this visual language are represented by bones, Here is avery simple 
bbchavior, the behavior for turning on the Lava Lamp: 


tetera tha ig ope ees eka or maar fipicton ees, Ti aioe 
Patepooing - 


Version of 5/31/01 


The entry point of any procedure is highlighted in green, Holding the contal-key and 
Jeft-clicking on any procedure will make it the entry point for that tre. A statement is 
cithera primitive ora procedure call. The Private: indicates that the procedure is local 
to the object, Global: indicates thatthe procedure is global. The small TE boxes 
indiate places where contol is returned from the procedure, with successor failure 
respectively. Arrows indicate flow of control. Notice that the statement in this procedure 
has two tabs, one T and one F, each representing a branch to take depending on whether 
‘or not the statement succeeded or ot. This is how conditional are implemented in his 
language. Ifa statement doesn’t have a conditional outcome, then only a single tab, with 
the label T, appears atthe bottom. Iteration is done via loops in the branching structure, 
with special primitives (eg, Set To Next) acting as generators. 


Primitive expressions enable the Eulith programmer to test, set, and mutate parameters, to 
run animations and play sounds, and do various other things. Integer id's are used to 
refer to objects. 


3. The Edith object editing and debugging environment 


The visible portion of Eth isthe object editing and debugging envionment. This 
section provides enough information to gt you started, but forthe rest, you're on your 


3.1 Installing Edith 
Copy Sine .©xe into the directory containing your legally obtained installation of The 

ims. Please note: This version of Edith isnot the latest version, and will nly work with 
The Sims, not any ofthe expansion packs. Also, add the objects that are on the class CD 
to the GameDatalObjects directory, and change their properties so that they are no longer 
read-only. Otherwise, you will not be able to et them 


3.2 Starting up Edith 
{tis important to note that Edith requires your display color depth tobe set to 16 bts. 
Moreover, you can only run Edith in windowed (as opposed to fll screen) mode. To do 
this, setup a shortcut which executes Sim®.exe, but with ~¥ asa command line 
parameter. When you execute your shortcut, you'll see The Sims stating almost as 
Usual, albeit ina window eather than taking up your entire seen. Choose a family t0 
‘work with, and then type “=o bring up the Edith window. 


When Edith starts up, you'll sce a scenario editor window. This lists information about 
the objects involved inthe scenario you are currently running, ie. the house and family 
you have chosen to look in on. Here's an example of what you might sec 
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anmesuebecermcek 


reed 
reef 
reef 
‘aa 


Feadan Boorse Henin 
reotany Bab Der 
reotany 


ahaa reir | 


‘Most ofthe buttons are standard, but the really useful stuff is under the Sims menu and 
the tied button from the right, which starts the Object Browser. 


3.3. The Object Browser 
The object browser provides tools fr programming objects. Click on an object o select 
it then choose what you want to do with it. The key buttons to know about are: 


‘+ Eai'Tree Table brings up the dialog for editing 
‘+ Bait Behavior brings up the dialog for editing routines associated with an object. 


3.4. Edit Tree Table Dialog 


‘You'll notice that there is. ao cancel button on this dialog. Any changes you make will 
not be actually recorded until you click on Save. You have heen warned, 


The Interactions pane! describes the interactions that an object makes available, The 
{index indicates wht order something shows up in the men, The Check Tree isa piece 
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of code that indicates whether or not that interaction should be available, given the state 
fof the object. If this code exits false then that behavior will not appear om the pie ment 
and also will not he available for autonomous selection by the Sims. ‘The Action tre is 
the action that is exceuted when that interaction is executed. The set of interactions can 
be edited with the buttons in this panel. Most of them are obvious (New adds a new 
interaction, Delete removes the selected interaction, SetClear Check’ ction buttons 
change those aspects of the interactions. The combo boxes are use to select actions, 
pulling them from the pool of procedures (aka tres). Private tees are stored with an 
jobject. Global tres are available to every abject. Semi-global procedures appear to be 
unused 


The Interaction Data pane! sets up how an interaction of an object affects people. 
Recall that objects provide interactions, an these interactions are advertised tothe Sims 
Here's what the parts do: 

‘+ Menu name isthe name ofthat interaction displayed on the menu that players see 
‘when they click on the object. 

"Attenuation sets how quickly the advertisement fades, A setting of none makes the 
strength of the advertisement independent of distance. In addition to the preset values 
(high, moderate low), one can set a custom value, 

* "Flags indicate to whom this interaction advertises, The “Available to” Nags are 
‘obvious, Allow Consecutive means tht this interaction can be queued up 

Joining is something you should just ignore 

‘+ Motives indicate how the appeal ofthe advertisement is modulted by the properties 
ofthe Sim, Reval that the Sims are constantly secing interactions tht will satisfy their 
needs (energy, comfort, hunger, hygiene, bladder, room, social, fun, mood), The motive 
settings determine how strong the advertisement wil be along different dimensions. For 
instance, a tilt advertises to Bladder, ina range from 0 to 70 (Set bythe Min and Max. 
boxes). If there is no variation by personality, the Max is used. Ifit does vary by 
personality, then the motive is scaled linearly according tothe number of points for that 
aspect ofthe personality. For instance, the aquaium's Feed Fish interaction provides 
between | and 11 on Fun, depending on the Playful personality component. You'll 
notice thatthe personality list actually inchudes polar opposites fr each tat (.. 
nice/grouchy,sctivellazy, et.) This isan intuitive way of handling a change of sign, ic., 
ifthe personality variation i chosen to be Serious, the more playful points the Sim has, 
the closer that dimension wil be to the minimum, 


3.5 Tweaking your Sims 


A good way to lear how a simulator works isto tweak is parameters and see how its 
behavior changes. The Sims menu inthe scenario window provides several ways to da 
this 


‘+ ‘Te Simulation Constants menu enables one to reset basie properties ofthe Sims, 
basically the rates at which various parameters change overtime. 
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‘+The Simulation Globals menu enables changing fundamental parameters of the 
‘mulation, such asthe person selected or whether oF not fee wil is enable, and 
properties ofthe houschold, such as the money available. 


3.6 Edith tips, tricks, and traps 


+ Back up your GameData directory frequently when programming with Eh 
Mysterious crashes ean happen, 

+ Alhough you can do i tis probably very unwise to eit global procedures 
‘unless you ae extremely sure you know what you're doing. You can break things 
very severely ifyoude, Global:Wait for Not fy isone example. Just back 
‘out, and let it do its job. 

+ Tweaking personality parameters and sates of objects is catively easy to do, 
‘Working with animations is really hard. The animations were made with 3D Studio 
Max plus a numberof plug-ins that are EA proprietary, and they simply aren't 
available. ‘The animations can include events, which is ane reason why they are so 
tricky. 

‘When editing procedures, make sure that you've terminated every node with 
ther a pointer to another node or an exit (TF box). Otherwise very bad things can 
Inappen. This isthe most common mistake when working in Eli, 

+ "Game tuning with new objects isa lot easier i you can gather data without 
‘keeping your eyes glued tothe screen. You can crete a logfile by invoking the chest 
window (Control-shif-C) and typing sim_1og begin. Lots of data is dumped 
into a txt file in your Sims directory, until you reenter the cheat window and type 
sim_log end. The data i ina format that can be read into a spreadsheet for 
further analysis 

+ You'll ind other handy abilities in the cheat window as well. For instance, you 
‘an set the hour so that time-based operations ean be tested, Hep gives you listing 
‘of commands 

‘+ Right-clicking ona box sets a breakpoint 

+ Ifyou find tons of small text lal boxes showing up when you look a ot, one 
per object, you probably have redundant objects in Your GameData\ Objects directory. 
Move the extra if files somewhere else and this problem will go away. 


4. Designing new objects 


Consider balance when creating your objects. Lifes full of tradeoffs, and navigating the 
constraint that they impose is part ofthe fun. Inthe game, objects that confer some 
benefit should also have some cost. "The most interesting costs are those which are 
indirect ~ unintended consequences of something that looked like a good idea, We'll ee 
that in our first object, 
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NORE 
44 The Joy Booth 


The Joy Booth i based onthe Joy Booths inthe classic Infocom game, “A Mind Forever 
Voyaging” and on the Orgasmaron from Woody Allens classic movie “Sleeper”. The 


Joy Booth catalog description is shown above, When you instruct a Sim to use the Joy 
Booth, itloaks something like this: 


Take a Dose 


(On the right i picture ofthe Joy Booth in operation. As you watch » Sim using i 
you'll notice tha their motions are like taking a shower, ait with their clothes on, Joy 
Booths quickly become popular household items, fun for dhe whole family and the 
neighbors: 
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ning relationships, and even lose slep to get another 
‘SimHeroin, if you will, something thatthe Sims find 
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How was the Joy Booth built? It was created in two pases. Fist, the Transmogrifier 
was used to create the Joy Booth visuals and change the catalog etry and price. The 
Transmogrifier documentation i excellent, so you can read that to find out how to use it 
The only caveat L would add is to be sure to give your new object a unique ID — 
otherwise it wll not show up inthe catalog. ‘The Jay Booth stared as # trnsmogrfied 
shower, with new textures, The shower was the appropriate starting point because i is 
fone ofthe few objects that Sims actually enter. (Recall that doing new animations 
outside Maxis is curently impossible, since they require proprictary tols.) The second 
phase isto use the Edith editor to reprogram the routines ofthe Shower that are copied 
‘ver during the transmogrification to make the new object behave like a Joy Booth. 


How should a Joy Booth work? For any object inthe Sims, we have to consider wis 
lbchavios it should have and how these behaviors should advertise themselves. A Joy 
oath is desenibed as heing use for saving time in avoiding relationship maintenance, 
This suggests tht taking a dose from the Joy Booth should provide Social and Fun 
payoils. Asa bonus, we'll provide a Mood payaffas well. Here are the values forthe 
Joy Booth: 


——— — oe 
a Tata Het [ota 
Gamal POPS eres | 
| itr ttt 


tree 


a) 
ral || ee | ae 
Deke = % umithe dies 
ae | F oaebaaoen 
pete 
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= 
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‘You'll se that we lef the intemal name of the routine (aks tre) to he Take Shower, but 
changed the way it resents tothe player as “Take a Dose". We've made it available to 
everyone inthe family and to visitors. It advertises strongly for Social, Fun, and Mood, 


eye 
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making ita good payoff for those circumstances where you might otherwise hang out 
‘with family, friends, and neighbors. 


How shold aking dose wrk? 1's weit think ofthis ners of iene fom 
tom he shower mek 

2 Shera ey bean iia, We wat he Jay Boch to bec in i 
{Shower sequre tang ene clos. Since oy Both ar inal npc 
places elie Sins Kec heroes on when wing oy Booth 

Pp serine ne Weve gong iv mere Soci, Fun tnd Mod sid 
tcnly doseage i Glow muy taps faving tn ack an ore 
tle sweat) 

Fever han itr thst pram be done stppg ot prt tho 
Take Shower routine, speiically nse pars which are concred wis cing and 
tcting dre agin (ee) and wonying aout privy (ec). Th implied version of 
Take Shower (ih totter ok ke Tae’ Dose) looks ke thi 


‘You'll notice that we frst try to go ta the font ofthe shower, facing it that fais, we 
exit. (Itcan fil Because someone else could be in it or blocking our route to it) Fit 


succeeds, we enter the shower and close the door (Private: enter shower and close 
door). Some magic with animation ensues, and ifthe mood is sufficiently high, singing 
inthe shower is enabled. Private:Shower core runs the animations for actualy taking & 
shower, and afterwards some more cleanup occurs. What happens on ext looks like 
thie 
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You'll notice that once we exit he shower, we increment Fun, Social, and Mood, and 
decrement Hygiene slightly, before doing some cleanup operations on the way out (the 
Global set room impact, animation reset, and Standard Ext). 


You'll notice that, viewed locally, the Joy Booth looks like a great object if your 
1cighborhood is sparsely populated or a Sim doesn't have very many friends ye, the Joy 
‘Booth will help them get through a day far more happily than they would be otherwise 
Regretably, as noted above its used atthe expense of doing socal actions that would 
bald statonstips, Ants nthe ent probaly is tery wsefal bet ave 


Creating addictive objects is relatively easy give some object's behavior high 
advertisements along some dimension, and you'll se that behavior chosen over and over 
again to satisfy them. What is more difficult is to ereate collections of objects that are 
balanced, where Sims interact with them in natural-looking pattems (ora least more 
amusingly Varied than an obsessive-compulsive exhibits) 


 Atiugh eve nding the aa f ation egies some ning. ay veo of the Jy Hoot 
re oat hat Sins wld cota sing antl they collapses. Note very aul nor ary 
Ties, pea the st tes However woul ban inereng cern to medi te Toy Boot at 
(a cee pononaity types were or lie find ery ang an (hey moult bap 
‘Snow adton bythe we aa Reon objet 0 
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4.2 Exercise: The Mood Adjuster 


The idea of Mood Adjuster i to get everyone in a party mood. As the eatalog entry 


‘As you can see, the Mood Adjuster surted out asa Transmogrified Lava Lamp, 
However, the Turn On behavior has been edited 1 represent the effects ofthe nanobots: 


Tine fe Sect et owe 
oe (ORES freeones = 
{4 ove] remenen 
aatNon Cont) Léed | exd| Twe| fen] dese) 


Ir ft cally the Private:SubOnOil routine, which handles the Lava Lamp aspect of is 
behavior. But before exiting, it also makes two changes to the person doing the 


‘operation: It increments the Outgoing parameter of ther personality by $0, and rests 
their Logi skills t 0. 
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As written, this routine has a couple of problems 
IL It seemsa litle extreme to make permanent changes to mood. ‘To be sure, that 
right be the way nanobots adjusting one's endocrine system might work out in 
practice, But it scems doubtful tht sucha product would remain on the market 
very long. It would be better ifthe etfcts were temporary 
2. The eflect is advertised in the catalog tobe affecting everybody, not just the 
person who turned it on, 


‘You might try as an exercise fixing the Mood Adjustor to overcome these problems 

Here are some hints: 
‘The engine underiying the Sims doesn't have much inthe way of compound data 
structures. However, there are a small number of unused parameters inthe Person 
‘object tht can be used as temporary caches, (This assumes that wo object authors 
don't ty the same trick at once, obviously.) 
‘In making the effects ofthe Mood Adjustr more global, there are two natural 
contexts: It affects everyone just in the same room it i in, oF affects everyone inthe 
hhouse. Whichever one you pick, you'll need titrate ever al of the people in the 
oom or house. Ifyou look at the tree Global::Privacy ~ test alone, you'll seea 
‘method for iterating through people and seeing if they are inthe same room, 
+ Visiting neighbors rise some intresting problems. They might come in after the 
Mood Adjustor is tuned on in which ease they won't be affected, but might have 
‘ery strange things happen if the Mood Adjustor is tuned off while they are there and 
their state is “popped”. They might be there when the Mood Adjustr is ted on, 
‘nut leave before it is tured off, im which case the changes to them will persist. One 
solution isto live with it~ nobody said nanotechnology was safe, did they? Another 
isto usea flag to indicate when somone has been Adjusted, and only pop values for 
‘those folks who have been Adjusted, (This doesn't help the neighbor leaving 
problem, however.) 


4.3. Some object suggestions 


Incase you don't have some ideas you ar itching to try, here are some suggestions to get 
you started: 


‘+ Nanobot Cleaners: Like the roaches, thes eriters swarm over your house. But they 
‘lean your house, including digesting trash on the floor. While expensive to purchase, 
they require no maintenance and even bring in a little income, because the trash that they 
digest is sold the local reeyeling plant. (Finally, a reason to have an intemet 
connection in your refrigerator @) However, at some infrequent interval, they will also 
‘warm over and digest some objec or pers) in the household by mistake 

‘+ Skeptical Sims: Objects advertise, to be sure, but curently Sims have no way of 
knowing whether or nt the experience was worth it. Relationship objects are used 
sparingly in The Sims, but they enable recording information about a Sim's relationship 
to another object. Try string all of the relevant variables in temporaries in & 
Relationship object before executing a behavior, and comparing them afterwards to see if 
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the object does indeed perform as advertised. ‘Then use this information to scale the 
advertisements when evaluating future interactions appropriately 
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